home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1996 #6 / Amiga Plus CD - 1996 - No. 06.iso / pd / netz / amitcphelperv1.20 / docsv1.20 < prev    next >
Text File  |  1996-06-29  |  19KB  |  460 lines
  1.  
  2.                            ·A·m·i·T·C·P·H·e·l·p·e·r·
  3.  
  4.                            - Version 1.20 29.VI.96 -
  5.                                   By Ben Vost
  6.  
  7.  
  8.  
  9. This is just a little gizmo to work with the Demon AmiTCP installation. It
  10. possibly will cope with any other AmiTCP setup so do try (if you are using it
  11. successfully with any other provider's software, or need some help to do so,
  12. please get in contact). 
  13.    
  14. It was written using a mixture of CanDo 2.0 and 3.0 (mostly 3.0 now) and
  15. requires the supplied cando.library (in libs:).
  16.  
  17. Unfortunately, any errors in location or setup just result in the program not
  18. running at all, with no explanation for what went wrong. Make sure that you
  19. have Rexxc in your path, or copy the "RX" program from Rexxc into C:. If you
  20. are using Elm and you get a message stating that sendmail couldn't be found,
  21. but Elm runs OK from shell, then you need to make sure that your sendmail
  22. command has the E bit set. If this isn't present it prevents sendmail from
  23. working through AmiTCPHelper.
  24.  
  25. Important note for existing users of AmiTCPHelper up to v1.16
  26. -------------------------------------------------------------
  27.  
  28. If AmiTCPHelper says that it won't work because of an incompatible library
  29. version you will need to download the full archive. Sorry about that, this is
  30. because I now have a slightly newer version of CanDo. Alternatively, I can
  31. e-mail you the library on its own...
  32.  
  33. Note for Demon users:
  34. ---------------------
  35.  
  36. AmiTCPHelper is designed to work OK with AmiTCPDIS95. I have downloaded DIS96
  37. and it does work with it, but because of changes to the programs included in
  38. the installation some of the script editing menus no longer work. For instance,
  39. DIS95 came as a CSLIP connection which uses a text file in db/ for its
  40. dialscript, whereas DIS96 comes with PPP and a dialler that stores its
  41. dialscript in RAM:. Please accept my apologies if you can't get all of
  42. AmiTCPHelper's facilities to work with your set up and e-mail me with your
  43. suggestions so that I may improve the way it works...
  44.  
  45.  
  46. Requirements
  47. ------------
  48.  
  49. As far as I know it should run on any Amiga with an AmiTCP installation (and
  50. possibly a Demon account :)). I have tested on an Amiga 3000 and 3000T running
  51. WB3.1 and also an A4000/040 running WB3.0. I don't think that there is a reason
  52. why it shouldn't run on an earlier operating system, but you do need ARexx. To
  53. use the GetNews button you must have the script "NNTPTransfer" in AmiTCP:bin.
  54. The provided nntptransfer script has a couple of alterations to the one
  55. provided by DIS, namely paths for all the commands and an automatic retry if
  56. News is busy (thanks Tez (Tez@tezboyes.demon.co.uk)).
  57.  
  58.  
  59. Installation
  60. ------------
  61.  
  62. This part's really tricky so pay attention.
  63.  
  64. Copy AmiTCPHelper anywhere you like. :)
  65.  
  66. AmiTCPHelper needs a script called "startnet" in Amitcp:bin/. You can set
  67. the tooltypes to reflect the programs you want to use for linking, ftp, mail,
  68. news, etc.
  69.  
  70. You should also copy the provided NNTPTransfer script in your AmiTCP:bin
  71. directory and copy the four edit scripts into your home: directory. These
  72. scripts are called '.fingerlist', '.pinglist', '.telnetlist' and '.tracelist'.
  73. Now these scripts have been moved to the home: directory it means that
  74. different users who login on the machine can have individualised scripts, just
  75. be sure to copy them to each users Home: directory...
  76.  
  77.  
  78.  
  79. Buttons
  80. -------
  81.  
  82. The buttons do what they say they do. If you have entered NONE for some of the
  83. tooltypes then the relevant button will be disabled in AmiTCPHelper.
  84.  
  85. The Mail button changed in version 1.07 to account for multiple mailboxes. The
  86. problem with the unfriendly mailboxes has been sorted out in version 1.11
  87. (thanks to Ben Scott) and now the mailbox names are presented in the
  88. requester's button as they should be. The mail button now also works with mail
  89. packages other than Elm. See the tooltypes Mail and ElmMail for further details.
  90.  
  91.  
  92. Ping, Finger, Trace & Telnet
  93. ----------------------------
  94.  
  95. This has changed in v1.15 so that you have four exclusive buttons (like radio
  96. buttons) which can be clicked on. The list below shows whatever addresses apply
  97. to the pushed in button. Double clicking on an entry in the list will result in
  98. the appropriate operation (ie. Fingering an address). The lists can be edited
  99. from the edit menu in the same way as the other config files and they should
  100. reside in your usr:lib directory. You can also edit the lists by double
  101. clicking on the appropriate button. Once you have edited the lists, simply
  102. close the editor down and click once on the appropriate button to refresh the
  103. list in the AmiTCPHelper window. The useability of these features has been
  104. improved in v1.19 so that you can now use the cursor keys to move up and down
  105. through the list, hitting return for the appropriate action. You can also use
  106. the Tab/Shift Tab keyboard shortcuts to move between the lists.
  107.     In version 1.20 I got rid of the previous Clock button since the only
  108. clocks anyone is likely to synchronise their machines to would be their local
  109. server. Thus, since you would only need one address, it was a bit of a waste of
  110. time to have a listview wasted so I changed the button to activate the TCP/IP
  111. command traceroute. Traceroute will show you the route taken by IP packets to
  112. the destination address. It can prove useful if it's taking a long time for
  113. your ftp client to respond, or just if you want to know exactly how you mail
  114. gets to its destination.
  115.  
  116.  
  117. Newsgroups
  118. ----------
  119.  
  120. This list window has been removed in v1.15. If anyone wants it to be
  121. reinstated, just mail me.
  122.  
  123. Tooltypes and their meanings:
  124. -----------------------------
  125.  
  126. If you enter NONE for the tooltypes for FTP, Mail, Gopher, WWW, or IRC, then
  127. AmiTCPHelper will disable the appropriate button.
  128.  
  129. WindowX        Gives the final x position of the AmiTCP helper on
  130.         the screen.
  131.  
  132. WindowY        Gives the final y position of the AmiTCP helper on
  133.         the screen.
  134.  
  135. FTP        Put the path and name of your favourite FTP tool here.
  136.         Possibilities would include "AmiTCP:bin/mftp" or
  137.         "Comms:AmiTCP/ftp", etc. (No quotes are needed). I
  138.         have tested it with both of these and with gui_ftp,
  139.         DaFTP, amftp and ncftp.
  140.  
  141. Mail        As for FTP. It has been tested with Elm and should
  142.         now also work with the newer GUI mail packages like
  143.         Metatool, Thor, Voodoo, etc. Make sure you check the
  144.         ElmMail tooltype if you are using one of these new
  145.         programs
  146.  
  147. WWW        As for FTP. Well, it's been tested with AMosaic (and
  148.         iBrowse, AWeb and Voyager), but if there is a secret Netscape
  149.         clone for the Amiga that I could test it with, will someone
  150.         PLEASE let me know? :). There is currently a problem with
  151.         iBrowse with AmiTCPHelper in that it doesn't CD to the iBrowse
  152.         directory. This means that unless you have either copied the
  153.         iBrowse libs to libs:, or added the iBrowse directory to the
  154.         libs: assign, you will get the message 'Could not open
  155.         ibconfig.library'. At the moment, it is beyond my powers to
  156.         remedy this situation.
  157.  
  158. Gopher        As for FTP. Tested with Graham's AmigaGuide-based
  159.         Gopher.
  160.  
  161. AmiTCPhome    This is the home directory for AmiTCP. Make sure you
  162.         include    trailing "/" or ":", ie. "Data:AmiTCP/".
  163.  
  164. Editor        This is the editor you will run when editing your
  165.         config in the menus. Put the complete path and name
  166.         of the program. To be able to edit the files it says
  167.         it can they have to be in the AmiTCP:db and
  168.         AmiTCP:usr/lib directories. Tested with TurboText,
  169.         CED and    one of my users says it also works with GoldEd.
  170.  
  171. Link        This is your *ARexx* link script. AmiTCPHelper
  172.         automatically looks for this script in your
  173.         AmiTCPHome bin directory. Tested with "Link" and
  174.         phil's (phil@curve.demon.co.uk) "PLink". Make sure you have
  175.         the 'RX' command in your path as mentioned above or this won't
  176.         work.
  177.  
  178. LinkOpts    The options for linking up. You should at least give
  179.         "up" as an option, but you can also put "up news" or
  180.         any other commands that your link script supports.
  181.  
  182. Ping        As for FTP. This is your Ping command.
  183.  
  184. Finger        As for FTP. This is the command you should use for
  185.         finger (oo-err).
  186.  
  187. Trace        As for FTP. This is for the traceroute command as explained in
  188.         the text above.
  189.  
  190. IRC        As for FTP. Enter the name of your IRC client.
  191.         Remember to include the path. Tested with Grapevine
  192.         and AmIRC.
  193.  
  194. Telnet        Your telnet application. It works with Telnet_VGOODER
  195.         from Demon and should work with most if not all of
  196.         the others.
  197.  
  198. Startnet    This tooltype determines whether you want the
  199.         startnet script executed by AmiTCPHelper or in your
  200.         user-startup. Enter yes for yes and no for no (quel
  201.         surprise!).
  202.  
  203. WinSize        WinSize sets the size for the output window that
  204.         AmiTCPHelper produces. It should consist of four
  205.         numbers separated by /. For instance:- 0/0/400/200.
  206.         This will open the window in the top left hand corner
  207.         of the screen which will be 400 pixels wide and 200
  208.         pixels high. You can't change the size (as far as I
  209.         know) of either the AmiTCP log or the dialscript
  210.         windows.
  211.  
  212. ElmMail        I know this might seem somewhat strange to have a
  213.         tooltype asking what mail package you are using and
  214.         then one asking if you are using Elm, but this
  215.         tooltype is there if your mail package supports the
  216.         command line -f option to specify a mail folder. If
  217.         you are using mail packages like Thor, Voodoo,
  218.         MetaTool or Mail, this tooltype should be set to
  219.         anything other than "yes". If in doubt, try it both
  220.         ways and see what happens...
  221.  
  222. SpoolCheck    I have been trying to get DOS notification to work
  223.         properly with AmiTCPHelper for some time now but it
  224.         doesn't like to check when mail has been sent. This
  225.         tooltype reinstates the old method which was to poll
  226.         UUSpool: every five seconds to check for the
  227.         existence of messages. If you don't want your hard
  228.         drive light to flash every five seconds or you are
  229.         using Snoopdos to sort a problem, you should set
  230.         SpoolCheck to "no".
  231.      
  232.      
  233. Menus:
  234. ------
  235.  
  236. Project Menu
  237.  
  238. About        This shows you what version of AmiTCPHelper you are
  239.         running and my name and email address.    
  240.  
  241. About CanDo    This gives some information about CanDo v3.
  242.  
  243. Quit        Surprisingly enough, this actually quits out of
  244.         AmiTCPHelper.
  245.  
  246.  
  247.  
  248. Edit Menu
  249.  
  250. DialScript    Lets you edit that dialscript...
  251.  
  252.  
  253. NewsStamp    Lets you edit the newsstamp so you aren't on the
  254.         blower downloading all night... :)
  255.  
  256. Newsgroups    Lets you edit the usr:lib/newsgroups file.
  257.  
  258. Signature    This lets you edit your HOME:.signature file.
  259.  
  260. Startnet    Lets you edit the startnet script. Changes made will
  261.         obviously not work until you re-run the startnet
  262.         script.
  263.  
  264. List        This opens a sub-menu which contains the names of the
  265.         various lists for Ping, finger, etc. Selecting one of
  266.         them will allow you to edit it.
  267.  
  268.  
  269. To Do List:
  270. -----------
  271.  
  272. I want to try to make AmiTCPHelper take notice if you edit the tooltypes
  273. without having to restart the program.
  274.  
  275. Warn the user when Linking down if there are messages remaining to be sent.
  276.  
  277. Amigaguide documentation. (Like it really needs it! :) )
  278.  
  279. Add a newsgroups editor that grabs the new newsgroups list from nntptransfer,
  280. and also lets you browse an "active" list. Done! It's a separate program called
  281. GroupEditor, downloadable from an Aminet site near you (comm/tcp).
  282.  
  283.  
  284. Legal Stuff:
  285. ------------
  286.  
  287.  
  288. Disclaimer
  289. ==========
  290.  
  291.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  292. LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER
  293. PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  294. EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  295. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
  296. QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
  297. DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  298.  
  299.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
  300. ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS
  301. PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  302. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  303. THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  304. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE
  305. PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY
  306. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  307.  
  308.  
  309. AmiTCPHelper is not Public Domain and is © Ben Vost 1995. If you register with
  310. me for £10 (or foreign currency equivalent), I will ensure that you receive all
  311. upgrades, until further notice, via EMail automatically. If you do not have an
  312. EMail facility, I'm not sure what I will do (and why are you using my
  313. program?!), but contact me at the following address:
  314.  
  315. EMail:    Ben@subway.demon.co.uk
  316.  
  317. SMail:  Contact me via e-mail first as I am in the process of moving at the
  318.     moment
  319.  
  320.  
  321. History
  322. -------
  323. v1.20    Got rid of the clock tool, but replaced it with a traceroute function.
  324.     Added an installer script thanks to my ex-colleague Neil Mohr (nice one
  325.     Neil). 
  326.  
  327. v1.19    Added functionality to the lists window.
  328.     Internal tidying up.
  329.     Added standard version string (important for internal and registered
  330.     versions.
  331.  
  332. v1.18    General tidying up. Also, I don't think many people had access to
  333.     v1.17, so this counts as a new public release.
  334.     I've also removed the time restriction as it made me seem petty. It was
  335.     only introduced because I was persuaded to do it...
  336.     Since iBrowse hit v6a it hasn't worked with AmiTCPHelper unless you
  337.     copy the libraries into LIBS:. This can't be changed for the moment, I
  338.     only suggest you add a new line to your user-startup that says:
  339.     "assign libs: XXX:iBrowseDemo add" where XXX: is wherever you've got
  340.     iBrowse stashed on your hard drive...
  341.     One last thing. I will be moving in the next week or so, so get in
  342.     touch with me via e-mail if you're thinking of registering...
  343.  
  344. v1.17    Removed the aliases and signature items from the edit menu
  345.     because they weren't editing the _correct_ alias and sig
  346.     files...
  347.     Added a check when you link down to see how many mails there
  348.     are remaining.
  349.     Implemented double clicking on one of the exclusive buttons
  350.     to start your defined editor for the particular file.
  351.     More internal tidying up (I've managed to free up several k's
  352.     worth of old routines that were no longer being used, but
  353.     that were still compiled into the program. Unfortunately,
  354.     adding new features increases the size again so the saving
  355.     doesn't really show...)
  356.  
  357. v1.16    ***IMPORTANT CHANGE*** AmiTCPHelper now only runs for ten
  358.     minutes before shutting down. Registering will remove this
  359.     restriction.
  360.     Internal tidying up.
  361.     AmiTCPHelper now supports mail packages other than Elm.
  362.     Dos notify for mail messages implemented, but not to my
  363.     satisfaction. A tooltype will allow for the old method to be
  364.     resumed.
  365.     Other odds and sods improved like the appearance of the list
  366.     window and the mail out area.
  367.  
  368. v1.15    Bit of a change around for this version, no more text fields
  369.     for Ping, finger, etc., but a list of addresses which can be
  370.     freely edited. Bang goes the Newsgroup list, but if anyone
  371.     wants it back, I can still replace it.
  372.  
  373. v1.14    There was no version 1.13 but only because I don't like to
  374.     tempt fate :) v1.14 sees the addition of the Mailqueue clone
  375.     to the AmiTCPHelper window. At the moment this checks
  376.     uuspool: every five seconds to see if there is new mail or if
  377.     mail has been sent. It creates a text file in T: called
  378.     SpoolList, so if you find your DOpus constantly rereading T:
  379.     that is the reason. 
  380.     Changed the About menu item back to the standard one, the one
  381.     in v1.12 was only for registered users.
  382.     Rewrote some of the documentation to stop it seeming so
  383.     dated.
  384.     Changed the way the mailboxes were checked and now the
  385.     requester will change dynamically if mailboxes are deleted.
  386.     In previous versions you had to restart AmiTCPHelper to see
  387.     any changes. The names in the requester are also now in
  388.     alphabetical order.
  389.     Internal simplification. I got rid of a couple of tooltypes
  390.     that didn't do anything along with their mentions in the
  391.     scripts.
  392.     
  393. v1.12    Yet another rejig of the buttons as the Prefs and Read News
  394.     buttons have been removed. Not sure if I like the new layout
  395.     so it might get changed yet again...
  396.     I've added a DOSNotify event to check to see if a new mailbox
  397.     has been added when mail is received. Previously, the only
  398.     time AmiTCPHelper checked for the names of the mailboxes was
  399.     at startup.
  400.     One internal change with regard to how registered owners are
  401.     dealt with...
  402.     Dumped the Prefs page as being beyond my capabilities and
  403.     also a bit pointless.
  404.  
  405. v1.11    Changed the nasty mailbox requester to something a bit more
  406.     standard.
  407.     Removed the Newsgroups backup option at startup.
  408.     Added a tooltype to allow AmiTCPHelper's output window to be
  409.     sized and positioned where desired.
  410.     
  411. v1.10    Added Telnet support (for completeness sake).
  412.     Added a new eight-colour (and four-colour) icon that freely
  413.     plagiarises the Xen style :)
  414.     More internal wrangling going on for the prefs page which
  415.     should be complete soon (maybe v1.12).
  416.     Added Startnet tooltype.
  417.  
  418. v1.09    Added startnet script editing in the Edit menu.
  419.     Added IRC and Prefs buttons to the interface which has been
  420.     jiggled to fit the new buttons in without requiring more
  421.     space. The Prefs button doesn't work at the mo, but will
  422.     eventually let you edit TCP-related ENV variables and the
  423.     co-ordinates and size of the windows that AmiTCPHelper opens
  424.     amongst other things.
  425.  
  426. v1.08    The Get News button now works! Hurrah!
  427.  
  428. v1.07    Changes made to the way Mail is dealt implemented in this
  429.     version.
  430.  
  431. v1.06    General tidying up.
  432.     Internal changes to the way mail is dealt with.
  433.  
  434.  
  435. v1.051    Changed the buttons to four colour ones for the Amiga
  436.     Computing Cover disk.
  437.  
  438. v1.05    Made Mail detach when run from AmiTCPHelper.
  439.     Added the Clock function.
  440.     Took out the sound samples, they were taking up far too much
  441.     space. If anyone wants them back, I can put them in just for
  442.     you.
  443.     Changed the About message and added the CanDo about.
  444.     Fiddled about with Get News, it's still not quite ready, but
  445.     hopefully the next release should see that button enabled.
  446.     (No promises... :) )
  447.  
  448. v1.04    Added support for multiple newsgroups.
  449.  
  450. v1.03    Changed the shape of the window to make it easier to use Ping
  451.     and Finger.
  452.     Miscellaneous internal tidying up.
  453.  
  454. v1.02    Added support for Ping and Finger.
  455.  
  456. v1.01     Added support for user definable link command and options.
  457.     Added better support for AMHotlist.
  458.     Added Info menu item.
  459.  
  460. v1.0     First public release